home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Comms & Internet / renam121 / Readme-Rename.txt < prev    next >
Text File  |  1997-06-17  |  15KB  |  323 lines
  1. HTML Rename!(TM) version 1.21
  2. Copyright (c) 1996, 1997 Parker & Associates
  3. All rights reserved
  4.  
  5.  
  6. WHAT DOES HTML RENAME! DO?
  7. --------------------------
  8. HTML Rename!(TM) eliminates the problems encountered when moving files 
  9. between DOS/Windows, Macintosh, and UNIX file systems.  By changing file 
  10. names (case, length, and invalid characters) and fixing links in HTML 
  11. code, HTML Rename! ensures that your files and Web pages will work on 
  12. any operating system.  Using HTML Rename! before you transfer files (for 
  13. example, uploading a Web site to a UNIX server) saves you from needing 
  14. to repair mangled filenames, broken links, and extra or missing carriage 
  15. return characters in text files.
  16.  
  17. HTML Rename! assists Web site development by checking the consistency of 
  18. URL links and generating reports on local and external URLs.  It 
  19. guarantees that your site will work on any operating system by enforcing 
  20. a file naming convention. HTML Rename! can automatically change every 
  21. filename to fit a new naming convention, or you can choose to 
  22. individually alter each invalid filename as HTML Rename! reviews it. Run 
  23. HTML Rename! before each Web site upload and never have another broken 
  24. link! 
  25.  
  26.  
  27.  
  28. HTML RENAME!'S FEATURES
  29. -----------------------
  30. * Targets DOS, Macintosh, UNIX, and other filesystems -- including ISO 
  31.   9660 (the most universal naming structure on the planet) 
  32. * Reports and renames files whose names are invalid on a target system
  33. * Automatically or interactively generates valid filenames
  34. * Updates links in your HTML pages for renamed files
  35. * Converts local links to relative or absolute URLs
  36. * Forces URL links to be case consistent with filenames
  37. * Alters file extensions such as HTML, JPEG, MPEG, & PING for the 
  38.   DOS/Windows, Macintosh, or UNIX convention (and fixes the names in the 
  39.   HTML code simultaneously)
  40. * Reports missing and external links
  41. * Reports files not referenced in a Web site (great for finding stray 
  42.   graphics and old files no longer in use)
  43. * Updates ASCII line ends for DOS/Windows, Macintosh, or UNIX format
  44. * Works on a single directory or an entire directory tree
  45. * Uses a clear, easy-to-follow, graphical wizard interface
  46.  
  47.  
  48. WHAT PROBLEMS DOES HTML RENAME! SOLVE?
  49. --------------------------------------
  50.  
  51. 1) Moving a Web Site to a Different System Can Break URL Links.
  52.  
  53. Typically, development of a Web site is done locally on a PC or 
  54. Macintosh and then uploaded to a server as the final "publishing" step.  
  55. If the server runs a different operating system than the local 
  56. development system, transferring the site to the server may break local 
  57. URL links.
  58.  
  59. One example of this is the strict filename upper and lower case 
  60. sensitivity in UNIX.  If you have an image file named "Janine.gif" and 
  61. reference that file as <a href "janine.gif"> the image will work when 
  62. testing on Macintosh or Windows.  On a UNIX server, however, you will 
  63. get a broken GIF because UNIX enforces stricter case sensitivity than 
  64. the Macintosh or Windows.  HTML Rename! fixes this by changing the URL 
  65. link to <a href "Janine.gif">, matching the filename exactly.
  66.  
  67. Other examples are characters which can appear in filenames on one 
  68. system but not on another.  For example, the filename "<Nov-96>.gif" is 
  69. valid on Macintosh and UNIX but not on Windows because of the greater-
  70. than and less than "<>" characters.  If you transfer a Web site 
  71. containing this file to an NT server, the links to this file will be 
  72. broken.
  73.  
  74. Yet another example is differing filename extensions.  For HTML, JPEG, 
  75. MPEG, and PING files; Macintosh and UNIX require the filename extensions 
  76. "html", "jpeg", "mpeg", and "ping"; while Windows requires "htm", "jpg", 
  77. "mpg", and "png".
  78.  
  79. HTML Rename! fixes all of the above problems, and more!
  80.  
  81.  
  82. 2) Verifying Your Web Site's URL Links
  83.  
  84. You can also use HTML Rename! to verify that your site is squeaky-clean 
  85. with no broken links.  HTML Rename! directly checks your local links and 
  86. generates a list of external URLs which you can check by loading the 
  87. list into your Web browser.  At the same time, HTML Rename! can verify 
  88. that no links will get broken in the process of uploading your Web site 
  89. to your server.
  90.  
  91.  
  92. 3) ISO 9660 Filenames for CD-ROMs
  93.  
  94. Many CD-ROM burning programs give you the option to automatically 
  95. convert filenames to ISO 9660 format, a specification which guarantees 
  96. all operating systems will understand the filenames.  HTML Rename! gives 
  97. you a finer granularity of control, allowing you to generate a report of 
  98. needed changes without renaming files, or to interactively rename files, 
  99. providing names which make more sense for your documents/data.
  100.  
  101.  
  102. 4) Graphical, Directory-based unix2dos, dos2unix, unix2mac, etc.
  103.  
  104. DOS/Windows, Macintosh, and UNIX all differ in their conventions for 
  105. line endings of ASCII text files.  As a result, files created on one 
  106. system and read on another may appear as one very long line, or with 
  107. garbage characters at the beginning or end of every line.  Most UNIX 
  108. systems have the dos2unix and unix2dos command line utilities to convert 
  109. files one at a time.  HTML Rename! provides a graphical user interface 
  110. to perform these operations on entire directories of files in one pass.
  111.  
  112.  
  113. SYSTEM REQUIREMENTS
  114. -------------------
  115.  
  116. HTML Rename! for Windows:
  117. 486/33MHz or greater processor
  118. 8MB RAM
  119. 5MB of free disk space
  120. Windows 95 or Windows/NT 3.51 or greater
  121.  
  122. HTML Rename! for Macintosh:
  123. 68020, 68030, or PowerPC
  124. 8MB RAM
  125. 5MB of free disk space
  126. MacOS System 7 or greater (7.5 or greater recommended)
  127.  
  128.  
  129. INSTALLATION
  130. ------------
  131. No special installation is required.  Simply extract the files from the 
  132. archive and HTML Rename! will be ready for use.  
  133.  
  134. HTML Rename! is distributed either as a self-extracting archive 
  135. ("renawNNN.exe" for Windows, "renamNNN.sea" for Macintosh) or as a 
  136. Windows zipped file ("renawNNN.zip") or Macintosh Stuffit file 
  137. ("renamNNN.sit"), where "NNN" represents the version number.  If you 
  138. have a self-extracting archive, simply double click on it to extract the 
  139. files.  Otherwise launch your favorite application to unzip or unstuff 
  140. the archive.  See below for the list of files in the archive.
  141.  
  142.  
  143. PRICING OF HTML RENAME!
  144. -----------------------
  145. HTML Rename! is shareware.  As such, it is available for a free 60 day 
  146. evaluation period, after that the software will disable itself.  If you 
  147. find HTML Rename! useful you must register and pay a registration fee as 
  148. follows:
  149.  
  150. HTML Rename! for Windows 95/NT:  US$20  per user
  151. HTML Rename! for Macintosh:           US$20  per user
  152.  
  153. When your registration payment is received you will be sent a 
  154. registration key and be granted a license to have unlimited use of a 
  155. single copy of HTML Rename!.
  156.  
  157. A Site License costs US$500 (equal to 25 users) and covers all locations 
  158. for your organization within a 160 kilometer radius of your site (100 
  159. miles).  One big advantage of a Site License is that you do not need to 
  160. keep track of how many people at your site are using the software.  A 
  161. World-Wide License costs US$2000 and it covers all locations for your 
  162. organization on the planet earth.  Site and World-Wide Licenses for HTML 
  163. Rename! for Windows or HTML Rename! for Macintosh must be purchased 
  164. separately.
  165.  
  166.  
  167. HOW DO I REGISTER HTML RENAME!
  168. ------------------------------
  169. Registering HTML Rename! is fairly simple.  Click the "Register..." 
  170. button in the initial Shareware Notice dialog.  Then either click on 
  171. "Register online with a credit card..." to launch your browser and take 
  172. you to HTML Rename!'s online registration site, or click on "Register 
  173. via email, fax, or postal mail..." to launch the Register program.
  174.  
  175. Kagi handles payment processing for HTML Rename!, you will make your 
  176. payments out to them.  See more information about Kagi below.
  177.  
  178. NOTE: It is important that you provide YOUR EMAIL ADDRESS during 
  179. registration.  Parker & Associates uses your email address to generate 
  180. the registration key which grants you unlimited use of a single copy of 
  181. HTML Rename!.  If you are ordering multiple copies or a Site or World-
  182. wide License, Parker & Associates will contact you with information on 
  183. how to complete your registration.
  184.  
  185.  
  186. REGISTERING ONLINE
  187. ------------------
  188. Currently, only credit and debit card transactions and payment via First 
  189. Virtual can be handled online.  Click on "Register online with a credit 
  190. card..." from HTML Rename!'s registration dialog or point your browser 
  191. at "http://order.kagi.com/?NK&S" for a secure server or 
  192. "http://order.kagi.com/?NK" for a normal server.
  193. Enter your name, your email address, and the number of single user 
  194. licenses you desire for each program you wish to purchase (or Site or 
  195. Word-Wide licenses).  Click the "Submit" button to continue to the next 
  196. page and enter your credit card information for submission to Kagi.
  197.  
  198.  
  199. REGISTERING WITH THE REGISTER PROGRAM
  200. -------------------------------------
  201. Registration via the Register program allows payment by credit card, 
  202. check, cash, and some forms of digital payment and may be submitted via 
  203. email, fax, or "snail mail."  Enter your name, your email address, and 
  204. the number of single user licenses you desire for each program you wish 
  205. to purchase (or Site or Word-Wide licenses).  Save or Copy or Print the 
  206. data from the Register program and send the data and payment to Kagi.
  207.  
  208. If paying with Credit Card or First Virtual, you can email or fax the 
  209. data to Kagi.  Their email address is sales@kagi.com and their fax 
  210. number is +1 510 652-6589.  You can either Copy the data from Register 
  211. and paste into the body of an email message or you can Save the data to 
  212. a file and you can attach that file to an email message.  There is no 
  213. need to compress the data file, it's already pretty small.  If you have 
  214. a fax modem, just Print the data to the Kagi fax number.
  215.  
  216. Payments sent via email are processed within 3 to 4 days.  You will 
  217. receive an email acknowledgment when it is processed.  Payments sent via 
  218. fax take up to 10 days and if you provide a correct Internet email 
  219. address you will receive an email acknowledgment.
  220.  
  221. If you are paying with Cash or USD Check you should print the data using 
  222. the Register application and send it to the address shown on the form, 
  223. which is:
  224.  
  225.           Kagi
  226.           1442-A Walnut Street #392-NK
  227.           Berkeley, California 94709-1405
  228.           USA
  229.  
  230. You can pay with a wide variety of cash from different countries but at 
  231. present if you pay via check, it must be a check drawn in US Dollars. 
  232. Kagi cannot accept checks in other currencies, the conversion rate for 
  233. non-USD checks is around USD 15 per check and that is just not 
  234. practical.  If you have a purchasing department, you can enter all the 
  235. data into the Register program and then select Invoice as your payment 
  236. method. Print three copies of the form and send it to your accounts 
  237. payable people. You might want to highlight the line that mentions that 
  238. they must include a copy of the form with their payment.
  239.  
  240. Kagi can not invoice your company, you need to act on our behalf and 
  241. generate the invoice and handle all the paperwork on your end.
  242.  
  243. Please do not fax or email payment forms that indicate Cash, Check or 
  244. Invoice as the payment method.  As far as we know, there is still no 
  245. technology to transfer physical objects via fax or email and without the 
  246. payment, the form cannot be processed.  Payments send via postal mail 
  247. take time to reach Kagi and then up to 10 days for processing.  Again, 
  248. if you include a correct email address, you will hear from Kagi when the 
  249. form is processed.
  250.  
  251.  
  252. WHAT IS THE CURRENT VERSION OF HTML RENAME!
  253. -------------------------------------------
  254. Check "http://www.visiontec.com/rename" to download the latest version.  
  255. If you are a registered user of HTML Rename!, you will receive email 
  256. notifying you of new releases.  Here is the current revision history:
  257.  
  258. HTML Rename! for Windows:
  259.   v1.00  27-Nov-96  Initial release
  260.   v1.10  10-Mar-97  Support for new tags, external text editor
  261.   v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  262.   v1.21  14-May-97  Fix relative URL substitution bug, base tags
  263.  
  264. HTML Rename! for Macintosh:  
  265.   v1.00  27-Nov-96  Initial release
  266.   v1.10  10-Mar-97  Support for new tags, external text editor
  267.   v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  268.   v1.21  14-May-97  Fix relative URL substitution bug, base tags
  269.  
  270. See the "History.txt" file for specific changes in each release.
  271.  
  272.  
  273. FILES IN THIS DISTRIBUTION
  274. --------------------------
  275. HTML Rename! for Windows 95/NT:
  276.   Readme-Rename.txt -- This file
  277.   Rename!.exe       -- HTML Rename! for Windows executable program
  278.   Register.exe      -- Shareware registration program for HTML Rename!
  279.   Register.hlp      -- Windows Help file for Register.exe
  280.   License.txt       -- Software license agreement for this software
  281.   LocalReg.html     -- Points to online registration page
  282.   File_id.diz       -- Quick identifier with product and version info
  283.   History.txt       -- Version history for what is new in each version
  284.  
  285. HTML Rename! for Macintosh:
  286.   Readme-Rename.txt -- This file
  287.   HTML Rename!      -- HTML Rename! for Macintosh application
  288.   Register          -- Shareware registration app for HTML Rename!
  289.   License.txt       -- Software license agreement for this software
  290.   LocalReg.html     -- Points to online registration page
  291.   History.txt       -- Version history for what is new in each version
  292.  
  293.  
  294. WHO DEVELOPED HTML RENAME!
  295. --------------------------
  296. HTML Rename! was developed by Parker & Associates, P.O. Box 2707, San 
  297. Anselmo, CA 94979 (tparker@kagi.com).  Terence M. Parker (Terry) founded 
  298. Parker & Associates in 1994 after 10 years of experience in Berkeley 
  299. software companies.
  300.  
  301. Terry's roles in software startups have included Vice President of 
  302. Engineering at Vividata, Inc. and principal designer of Caere's OmniPage 
  303. optical character recognition product for UNIX/Motif.  His work has 
  304. included all aspects of software development and support, from initial 
  305. design through end-user support.  This experience is all brought to bear 
  306. on HTML Rename!.
  307.  
  308. HTML Rename! was born when Ken Milburn, one of the authors of 
  309. "Converting Content for Web Publishing" called Terry, saying that he had 
  310. not been able to find a much-needed utility to rename files.  Terry, who 
  311. has developed products for DOS, Windows, Macintosh, UNIX, etc., saw the 
  312. usefulness of such a utility and got a little carried away.  The result 
  313. (together with insights from the authors of Converting Content for Web 
  314. Publishing) is HTML Rename! -- a sophisticated, professional program 
  315. carefully designed and tested, and ready for serious work. 
  316.  
  317. To find out more about Terry and the authors of "Converting Content for 
  318. Web Publishing", check out the Web site "http://www.visiontec.com".
  319.  
  320.  
  321. Last updated: 14-May-97
  322. ###
  323.